---
title: 'OpenAI SDK'
description: 'Connect OpenAI models to your AgentRPC tools'
icon: 'circle'
---

<iframe
  src="https://player.vimeo.com/video/1066820347?h=6bbf54c9ef"
  frameBorder="0"
  height="500"
  className="w-full aspect-video"
  allowFullScreen
  webkitallowfullscreen
  mozallowfullscreen
  title="AgentRPC - Open AI Agents SDK Setup"
/>

## Python

### Agents SDK

Connect AgentRPC tools to the [OpenAI Agents SDK](https://github.com/openai/openai-agents-python).

#### `rpc.openai.agents.get_tools()`

The `get_tools()` method returns your registered AgentRPC functions as OpenAI Agent tools.

```python
# First register your functions with AgentRPC (Locally or on another machine)

# Attach the tools to the Agent
agent = Agent(name="AgentRPC Agent", tools=rpc.openai.agents.get_tools())

result = await Runner.run(
    agent,
    input="What is the weather in Melbourne?",
)

print(result.final_output)

```

### Completions SDK

Connect AgentRPC tools to the [OpenAI Completions SDK](https://github.com/openai/openai-python).

#### `rpc.openai.completions.get_tools()`

The `get_tools()` method returns your registered AgentRPC functions formatted as OpenAI tools, ready to be passed to OpenAI's API.

```python
# First register your functions with AgentRPC (Locally or on another machine)

# Then get the tools formatted for OpenAI
tools = rpc.openai.completions.get_tools()

# Pass these tools to OpenAI
chat_completion = openai.chat.completions.create(
  model="gpt-4-1106-preview",
  messages=messages,
  tools=tools,
  tool_choice="auto"
)
```

#### `rpc.openai.completions.execute_tool(tool_call)`

The `execute_tool()` method executes an OpenAI tool call against your registered AgentRPC functions.

```python
# Process tool calls from OpenAI's response
if chat_completion.choices[0].tool_calls:
  for tool_call in response_message.tool_calls:
    rpc.openai.completions.execute_tool(tool_call)
```

For more details, visit the [Python SDK GitHub repository](https://github.com/agentrpc/agentrpc/tree/main/sdk-python).

## TypeScript

Connect AgentRPC tools to the [OpenAI Completions SDK](https://github.com/openai/openai-node).

You can use the `rpc.OpenAI` object to get tools formatted for the OpenAI Completions SDK.

```typescript
// Get tools formatted for OpenAI completions SDK
const tools = await rpc.OpenAI.getTools();

// Pass these tools to OpenAI
const completion = await openai.chat.completions.create({
  model: "gpt-4o",
  messages: messages,
  tools: tools,
  tool_choice: "auto",
});

const responseMessage = completion.choices[0]?.message;

// Execute tool calls from OpenAI's response
if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {
  for (const toolCall of responseMessage.tool_calls) {
    const result = await rpc.OpenAI.executeTool(toolCall);
    // Use the result...
  }
}
```

For more details, visit the [NodeJS SDK GitHub repository](https://github.com/agentrpc/agentrpc/tree/main/sdk-node).
